home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / grn_2_1.zip / MAILMIND.LZH / mailminder.doc < prev    next >
Text File  |  1992-02-26  |  4KB  |  98 lines
  1. MailMinder 1.20 (Beta)
  2.  
  3. Every UUCP package needs the animated mailbox icon on the desktop, and
  4. since Dillon's UUCP package is minus this feature, I decided to implement
  5. it myself.  MailMinder is a workbench-only application (does not run
  6. from the CLI - it just prints an error message).  Typically, you will
  7. drag the MailMinder icon into your WBStartup so it can be launched 
  8. automatically by Workbench when you boot up.  MailMinder basically
  9. puts an apicon on your workbench that looks like a mailbox.  If you
  10. have no mail, the flag is down.  If you have mail, the flag goes up.
  11. It's that simple.
  12.  
  13. MailMinder uses ToolTypes to give it added flexibility.  The possible
  14. tooltypes are:
  15.  
  16.     MAILDIR=path_to_mail
  17.     USERNAME=name_of_user
  18.     HASMAIL=flagup_icon
  19.     NOMAIL=flagdown_icon
  20.     LOGFILE=filename
  21.     IFMAIL=command_string (full path)
  22.     CLICKMAIL=command_string (full path)
  23.     CLICKNOMAIL=command_string (full path)
  24.     DONOTWAIT
  25.  
  26. Description:
  27.     MAILDIR must be specified.  This specifies the path to the mail file 
  28.         (path, not name) to be watched.
  29.     USERNAME must be specified.  This specifies the filename to be watched.
  30.     HASMAIL must be specified.  This is the name of the .info file to display
  31.         when the user has mail.
  32.     NOMAIL must be specified.  THis is the name of the .info file to display
  33.         when the user has no mail.
  34.     LOGFILE is optional.  If specified, error messages are printed to this file.
  35.         If not specified, no error messages are possible.
  36.     IFMAIL is optional.  If specified, when the user has mail, the command string
  37.         is executed.
  38.     CLICKMAIL is optional.  If specified, when the user has mail and the icon is
  39.         clicked on, the command string is executed.
  40.     CLICKNOMAIL is optional.  If specified, when the user has no mail and the icon is
  41.         clicked on, the command string is executed.
  42.     DONOTWAIT is required if you want to have MailMinder run from your WBSTARTUP
  43.         drawer.
  44.  
  45. The mailminder.info file that comes with this distribution illustrates some of the
  46. possibilities for how to set up your tooltypes.  In my case, I have it set up to
  47. startup a newcli running DNews when you click on the icon when there is mail.  I
  48. removed the MailReadyCmd variable from my uulib:config file, since it isn't really
  49. needed anymore.  Theoretically, you can have MailMinder startup AnyMail (or whatever)
  50. when it is clicked on...
  51.  
  52. My setup has 
  53. MAILDIR=uumail: (where my mail comes)
  54. USERNAME=mykes (that's me)
  55. HASMAIL=uucp:c/havemail (you can put the icons wherever you want)
  56. NOMAIL=uucp:c/nomail (you can put this icon wherever, also)
  57. LOGFILE=uuspool:mmerrs (mailminder's error log)
  58. etc.
  59.  
  60. If you run mailminder from the cli, it simply prints an error message and quits.
  61. Since MailMinder has no stdout, I chose to have it print its error messages
  62. to the logfile.  If you are having trouble getting it to work, check the logfile!
  63.  
  64. If you want, you can run two MailMinders at the same time to watch different incoming
  65. files.  I happen to use it to watch my uumail:mykes and my uumail:grnbugs.  I get
  66. two icons as you'd expect.  I used WBLink by Dave Schreiber to create a link to
  67. MailMinder and simply changed the tooltypes for the link's .info file to what
  68. I wanted.
  69.  
  70. If you want to manually start MailMinder, simply doubleclick the icon.  If you want
  71. to kill a particular MailMinder, doubleclick the icon again.
  72.  
  73. The enclosed example email-startup script is from my s: directory.  It is
  74. executed by a CLI started up when the AppIcon is doubleclicked and there IS
  75. mail.
  76.  
  77.  
  78. Please send any bug reports, enhancement requests, and especially prettier icons
  79. to me at mykes@amiga0.sf-bay.org.
  80.  
  81. Fixed in 1.10
  82.  
  83. 1.    MailMinder now treats a zero length mbox (or whatever) as if it doesn't
  84.     exist.  This makes it work great with Elm and other mail programs
  85.     that don't delete the files they use.
  86.  
  87. Fixed in 1.20
  88.  
  89. 1.    Included new icons sent by users.
  90.  
  91. 2.    Added MailMinder to the GRn distribution.
  92.  
  93. Included with MailMinder are custom Icons drawn by Paul Broe, Dave Connors,
  94. Stephan Lussier, and Andy Wright.  My thanks to these guys!  Special thanks
  95. to Andy Wright, who passes along some very nifty scripts and such to go
  96. along with MailMinder.
  97.  
  98.